home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Plus 2003 #12
/
Amiga Plus CD - 2003 - No. 12.iso
/
AmiSoft
/
Util
/
Moni
/
Scout.lha
/
Scout
/
help
/
english
/
scout.doc
< prev
next >
Wrap
Text File
|
2003-11-03
|
70KB
|
2,376 lines
Scout 37.227
Release 3.0
User's Manual
Copyright (C) 1994-2002 Andreas Gelhausen, Richard K"orber, Thore B"ockelmann
1m22m1m22m1m22m1m22m1m22m1m22mWhat is Scout?
==============
1m Scout22m is a tool that allows you to monitor your computer system. It
displays many different things -- like tasks, ports, assigns, expansion
boards, resident commands, interrupts, etc. -- and you can perform
some certain actions on them.
For example you can freeze tasks, close windows and screens, release
semaphores or remove locks, ports and interrupts.
Through 1mAmiTCP22m it's also possible to use 1mScout22m as an TCP/IP service.
Since version 2.0 of 1mScout22m you can use nearly all implemented
functions through shell parameters. Therefore it's not necessary to
install 1mMUI22m for using 1mScout22m, but you will need 1mMUI22m, if you want to use
1mScout22m with its graphical user interface.
Copyright
=========
Please read the following parts carefully. You accept the following
terms by starting the software, even for a test drive only.
1mCOPYRIGHT22m
Scout 37.227 (Release 3.0) - Copyright (C) 1994-2002 by Andreas
Gelhausen, Richard K"orber and Thore B"ockelmann, all rights
reserved.
You only have the right to use the software, but no rights on the
software itself. Disassembling, resourcing and all other ways of
reverse engineering is forbidden.
1mFREEWARE22m
Scout is FreeWare. You are allowed to use the packet without
paying a fee or similar to the authors. Of course we would
appreciate a small donor! ;-)
1mCOPYING22m
You can copy the packet as long as it remains entire and unchanged.
You are allowed to compress the packet using a customary
compression software (as lha, lzh, lzx, dms). You must not
compress single files of the packet (e.g. PowerPacker or Imploder).
1mDISTRIBUTION22m
You must not exceed an usual price on the market for your working
and material. This means a maximum of 5 DM (or the equivalent
amount in other currencies, including all taxes) for disks and 35
DM for CD-ROMs containing a PD software collection.
In any case, you need a written permission from us if you want to
include Scout on a cover disk or in connection with a commercial
product.
We explicitly permit the distribution via AmiNet, Meeting Pearls
and Fred Fish.
1mLIABILITY22m
You are using the program as it is, with all flaws, and on your
own risk! We grant no warranty for the software meeting a special
purpose. This software may cause financial damage or harm people.
1mLIMITATIONS22m
You are not allowed to use this software and its results
* for fascism or military purposes
* if you do not agree to the copyright note
In this case you must delete the software and all related and
generated files immediately!
1mCONTENTS OF THE PACKET22m
The Scout packet is 3monly23m entire with these files:
Scout/arexx/activatetask.scout
Scout/arexx/arexx.readme
Scout/arexx/arexx.readme.info
Scout/arexx/breaktask.scout
Scout/arexx/freezetask.scout
Scout/arexx/poptofront.scout
Scout/arexx/settaskpri.scout
Scout/arexx/startup.scout
Scout/arexx.info
Scout/help/deutsch/scout-39.guide
Scout/help/deutsch/scout-39.guide.info
Scout/help/deutsch/scout.doc
Scout/help/deutsch/scout.doc.info
Scout/help/deutsch/scout.dvi
Scout/help/deutsch/scout.guide
Scout/help/deutsch/scout.guide.info
Scout/help/deutsch.info
Scout/help/english/scout-39.guide
Scout/help/english/scout-39.guide.info
Scout/help/english/scout.doc
Scout/help/english/scout.doc.info
Scout/help/english/scout.dvi
Scout/help/english/scout.guide
Scout/help/english/scout.guide.info
Scout/help/english.info
Scout/help.info
Scout/icons/icons.readme
Scout/icons/icons.readme.info
Scout/icons/Scout.info
Scout/icons/ScoutDock
Scout/icons/ScoutDock.info
Scout/icons.info
Scout/libs/identify.library
Scout/libs/identify.readme
Scout/libs/identify.readme.info
Scout/libs.info
Scout/Product-Info
Scout/Scout
Scout/Scout.info
Scout/scout.history
Scout/Scout.history.info
Scout/Scout.readme
Scout/Scout.readme.info
Scout.info
1mTRADEMARKS22m
All copyrights and trademarks are held by their owners.
System Requirements
===================
1mScout22m only requires AmigaOS version 2.04. The 1midentify.library22m V8 is
not required, but I strongly suggest to install it to give Scout its
full power. See also Identify.
If you want to use 1mScout's22m graphical user interface, you also have
to install 1mMUI22m version 2.1 or higher. See also MUI.
The TCP/IP features of 1mScout22m are only available, if you have
installed the version 4.0 of 1mAmiTCP22m. See also AmiTCP.
MUI - MagicUserInterface
========================
(C) Copyright 1992-97 by Stefan Stuntz
MUI is a system to generate and maintain graphical user interfaces.
With the aid of a preferences program, the user of an application has
the ability to customize the outfit according to his personal taste.
MUI is distributed as shareware. To obtain a complete package
containing lots of examples and more information about registration
please look for a file called 1mmuiXXusr.lha22m (XX means the latest version
number) on your local bulletin boards or on public domain disks.
If you want to register directly, feel free to send DM 30.- or US$
20.- to
Stefan Stuntz
Eduard-Spranger-Strasse 7
80935 M"unchen
GERMANY
Identify
========
Copyright (C) 1996-97 Richard K"orber
1m Identify22m is a Shared Library that decodes expansion IDs, guru codes
and library functions, and identifies your system.
1m Identify22m is FreeWare. You can find a complete package in the AmiNet
(1mutil/libs/Identify.lha22m) or on the author's home page:
1mhttp://www.is-koeln.de/einwohner/shred/22m. To get in contact, write to
1mshred@chessy.aworld.de22m.
AmiTCP
======
1m AmiTCP22m is a TCP/IP protocol stack for the Amiga. The demo version
4.0 (or higher) should be available in greater public domain
collections or on the AmiNet. Ask your preferred Amiga dealer. =:^)
Installing Scout
================
You only have to copy the program 1mscout22m to your favourite directory,
and 1midentify.library22m to 1mlibs:22m. Then you can start it.
How to use Scout
****************
This chapter describes the usage of 1mScout22m through its graphical user
interface. This graphical user interface is based on the 1mMagic User
Interface22m (1mMUI22m) and 1mMUI22m have to be installed in your system, if you
want to use 1mScout22m trough windows and so on.
If you don't like 1mMUI22m, you should see Scout without MUI.
If you start the program you will see the main window which includes
many gadgets. Each of these gadgets represents a certain kind of
system structure.
You can choose between:
Allocations, Assigns, BoopsiClasses, Commodities, Devices,
Expansions, Fonts, InputHandlers, Interrupts, Libraries, Locks,
LowMemory, Memory, Mounted Devices, Ports, Resident Commands,
Residents, Resources, ScreenMode, Semaphores, System, Tasks, Timer,
Vectors, Windows, Patches, Catalogs and AudioModes.
Click one of these gadgets and another window will be opened with a
list of the structure type that is indicated on the pressed gadget.
1m Example:22m Press the task gadget and you will get a window with the
list of tasks and processes.
You can also select these functions by pressing the underlined key
you see on each gadget or by using the right mousebutton menu.
If you wish to handle/remove a given structure, you should know what
you do.
1m Warning:22m Wrong handling of the showed structures can crash your
system. At the worst you will lose your data.
1mPlease note:22m You should not be surprised, if you don't find a certain
detail information in this manual, because it's to much work to explain
each element of all the structures you could see in this program.
Many books are written about these things and if you want to have
more information about them, you should have a look in the specialized
literature.
Allocations
===========
This window informs about who allocated what hardware resource.
CIA
---
The Amiga owns two CIA to control its hardware, the keyboard and the
printer interfaces. Additionally, it contains a couple of timer. This
window shows which parts of the CIA are not yet allocated, or which
program allocated the resource.
1mTimer A22m
1mTimer B22m
This are two 16bit timer. They can also be coupled to a 32bit
timer.
1mAlarm22m
This resource informs if a third timer reached an alarm value.
1mSerial22m
This is a simple serial interface. Usually, the CIA-A one's is used
for communicating with the keyboard. The CIA-B serial interface
will not be allocated in most cases.
1mFlag22m
This is a special control line. It is connected from the CIA-A to
the Index line of the floppy disk drives.
Note: newer DraCos do not contain the CIA chips. Thus, these
hardware resources will be emulated or are even not offered.
Ports
-----
This are the resources for the internal parallel and serial
interfaces.
1mSerial Port22m
This are the plain data transfer registers (transmitting and
receiving).
1mSerial Control22m
This are the serial control lines, as Carrier Detect.
1mParallel Port22m
This are the data lines of the parallel port.
1mParallel Control22m
This are the control lines of the parallel port, as Busy or Paper
Out.
Actions
-------
1mUpdate22m
The window is updates each time you press this button.
1mPrint22m
The window's contents are printed or saved to a file of your
choice.
1mExit22m
The window will be closed.
Assigns
=======
This type of structure assigns a logical name to a directory.
If you assign the directory 1mdh0:data/documents22m the logical name
1mtexts:22m, you will also be able to choose a file FILENAME in that
directory with the path `texts:FILENAME'.
Column items
------------
1mAddress22m
Address of the assign structure.
1mName22m
Logical name of a directory
1mPath22m
Here you will find the path of the directory.
Actions
-------
1mUpdate22m
Selecting this gadget updates the list of assigns.
1mPrint22m
This function allows you to send the list of 1mAssigns22m to printer or
a selected file.
1mRemove22m
The selected assign will be removed with this function.
1mExit22m
The 1mAssigns22m window will be closed.
BoopsiClasses
=============
BOOPSI classes are object oriented classes. The classes in this list
are all classes that are publically available from intuition.
Column items
------------
1mAddress22m
This is the address of the 1mIClass22m structure, which contains all
data of this class.
1mObjects22m
Shows the current amount of objects constructed by this class.
1mSubclasses22m
Shows the current amount of sub classes (public and private) which
are derived from this class.
1mSuperclass22m
A pointer to the 1mIClass22m structure of the parent class.
1mDispatcher22m
A pointer to the dispatcher code, which realizes all methods of
the class.
1mName22m
The name of the class.
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list to printer or a selected
file.
1mRemove22m
Removes the selected class from the system. This is only possible
if neither objects nor sub classes exist from this class.
1mMore22m
Opens a window with further information.
1mExit22m
Closes the window.
Commodities
===========
Commodities are small utilities. Most of them react on the input
stream, or manipulate it.
You can find some commodity examples in the 1mTools22m drawer of your
Workbench.
Column items
------------
1mAddress22m
Points to the 1mCxObj22m structure of the commodity, containing all
data about it.
1mln_Type22m
Structure type. Usually, it will be 1mBroker22m.
1mln_Pri22m
Priority of the commodity broker.
1mFlags22m
Flags describing the broker.
1mPort22m
All messages of the broker are sent to this MessagePort.
1mName22m
Name of the commodity.
Actions
-------
1mAppear22m
1mDisappear22m
Let the selected commodity's GUI pop up or disappear. Some
commodities do not have a GUI.
1mEnable22m
1mDisable22m
The commodity will be enabled or disabled.
1mKill22m
Let the selected commodity remove itself in a clean way.
1mListChg22m
1mUnique22m
The commodity is notified that the list has been changed or that
another commodity with the same name was about to be added. This
is only useful for programmers to test out their commmodities.
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list to printer or a selected
file.
1mPriority22m
This function allows you to change the priority of a commodity.
1mRemove22m
Removes the selected commodity from the system. Please try a
frienly remove before, using 1mKill22m. Maybe the commodity removes
itself voluntarily. =;^)
1mMore22m
Opens a window with further information.
1mExit22m
Closes the window.
Devices
=======
A device is -- like a library (see Libraries) -- a collection of
functions/procedures, which have to do certain jobs.
E.g. the 1mtrackdisk.device22m includes functions for the floppy disk
handling.
Column items
------------
1mAddress22m
Address of the device structure
1mln_Name22m
Name of a device
1mln_Pri22m
Priority of a device
1mOpenC22m
This element shows how often the device was opened.
1mRPC22m
1m RPC22m means 1mRAM Pointer Count22m and shows how many jump addresses of
the device point into RAM. In this way many programs -- like the
1msetpatch22m command from Commodore -- patch the system.
Many viruses patch the system in this way too, but don't panic now.
If you check your system in regular intervals with a current virus
killer, it should be out of danger.
If the whole program code of the device is located in RAM, you will
find a dash (minus sign) here, because in this case it's
unimportant how many jump addresses point into RAM.
1mln_Type22m
Type of this structure (usually 1mdevice22m)
Actions
-------
1mUpdate22m
If you select this gadget, the list of devices will be updated.
1mPrint22m
This function allows you to send the list of 1mDevices22m to printer or
a selected file.
1mRemove22m
The selected device will be removed with this function provided
that no program uses this device anymore and the 1mOpenC22m is zero.
1mPriority22m
Herewith the priority of the device can be changed. A little
window will be opened, that asks you for a new priority. Through
the new priority it can happen that the device gets a new place in
the device list.
1mMore22m
Another window will be opened and you will see more informations
about the selected device.
You will have the same effect, if you doubleclick an element of the
device list.
1mFunctions22m
All device function offsets and addresses are shown up in a
subwindow. If an appropriate 1m.fd22m file exists and an 1mFD:22m assign
points to its directory, then you will also see the function names.
1mExit22m
The 1mDevices22m window will be closed.
Expansions
==========
1m IMPORTANT:22m All Scout releases before 2.10 are not compatible to this
release! So if you want to read this list using TCP/IP, make sure that
the remote system runs the latest version as well!
This window shows a list about all your expansion boards (graphic
boards, memory expansions and so on) too.
Column items
------------
1mAddress22m
The address of the expansion structure.
1mBoardAddr22m
Usually you will find the ROM of the card here. If this address
points into RAM, the card is a memory expansion.
1mType22m
Information about the board. See the More window for further
information.
1mManufacturer22m
Name of the board manufacturer.
1mProduct22m
Name and class of the product.
Additional information
----------------------
If you select one item from the list, the text field below shows up
some additional information:
1mSize22m
If the entry belongs to a memory expansion, the size of the memory
is displayed here. Otherwise it's the ROM size of the card.
1mFlags22m
See the More window.
1mID22m
ManufacturerID, assigned by Commodore, followed by the
Productnumber, assigned by the manufacturer of the board.
1mSN22m
Serialnumber of the card (usually unused)
Actions
-------
1mPrint22m
This function allows you to send the list of 1mExpansions22m to printer
or a selected file.
1mMore22m
Now a window will be opened, that includes more informations about
the selected expansion board.
Doubleclick an element of the 1mExpansions22m list and you will have
the same effect.
1mExit22m
The 1mExpansions22m window will be closed.
Unknown expansion boards
------------------------
If you select an expansion board by selecting its list item, you will
get the name of the manufacturer and the card in the textfield you find
below the list, provided that the installed version of 1midentify.library22m
knows about these data.
If no information is available in this textfield or the given
information is wrong, you should send me the following data, please.
1. ManufacturerID (Manufacturer)
2. ProductID (Product)
3. Name of the company
4. Name of your expansion card
5. Function of your card
If you send me these data, the next version of 1mIdentify22m will include
your expansion boards. Please be as precise you can.
Fonts
=====
This function will show you all fonts existing in your system.
Column items
------------
1mYSize22m
Vertical size of the font
1mCount22m
Here you can see how many programs use the font.
1mType22m
1m ROMFONT22m means the font is located in ROM and 1mDISKFONT22m means the
font was loaded from disk/harddisk.
1mName22m
Name of the font
Actions
-------
1mUpdate22m
The list of fonts will be updated.
1mPrint22m
This function allows you to send the list of 1mFonts22m to printer or a
selected file.
1mClose22m
The font will be closed by using this function.
1mRemove22m
It is possible to remove a font from system, provided that no
program uses it and it's no 1mROMFONT22m.
1mExit22m
The 1mFonts22m window disappears.
InputHandlers
=============
Input handlers take care of all user input arriving in system
(pressed keys, mouseclicks, inserted disks, etc.). They stand one
behind the other like on a production line and analyze the user input.
The input handler with the highest priority gets the `events' first and
if it doesn't know how to react on these `events', the second input
handler gets them, and so on.
Usually the system input handler has a priority of 50. Every input
handler, that wants to get the user input before the system, must have
a higher priority.
Column items
------------
1mln_Name22m
Name of the input handler
1mln_Pri22m
Its priority
1mis_Data22m
This address points to some data needed by the input handler.
1mis_Code22m
The program code starts here. If the code is located in RAM, the
address is of different color. Otherwise you can find the code in
ROM. Some viruses install an input handler in system. In this
case the 1mis_Code22m address points into RAM, but many other programs
uses input handlers, too. Don't panic!
Actions
-------
1mUpdate22m
The list of input handlers will be updated when you select this
gadget.
1mPrint22m
This function allows you to send the list of 1mInputHandlers22m to
printer or a selected file.
1mRemove22m
Removes an input handler from system.
1mPriority22m
Changes the priority of an input handler.
1mExit22m
The window will be closed.
Interrupts
==========
Interrupts are important events the computer system has to react on.
It exists a list of interrupt routines for each interrupt type. If a
certain interrupt occurs, all these interrupt routines will be called.
During their execution the running program will be interrupted.
Column items
------------
1mln_Name22m
Name of the interrupt
1mln_Pri22m
Its priority
1mis_Data22m
At this address you find the data of the interrupt.
1mis_Code22m
Address of the interrupt code. If this address points into RAM,
it's of a different color.
1mNUM22m
This number represents the type of event the interrupt routine is
called on. The 1mIntName22m you find in the interrupt detail window
gives you a little bit more information about it.
1m Example:22m Number 5 means that the interrupt is called at every
vertical blank interval.
Actions
-------
1mUpdate22m
The list of interrupts will be updated.
1mPrint22m
This function allows you to send the list of 1mInterrupts22m to printer
or a selected file.
1mRemove22m
If the interrupt is a server you can remove it from system. An
interrupt handler can't be removed by 1mScout22m.
If you call 1mavail flush22m and the audio.device isn't used, the
interrupt handlers of the audio.device will be removed.
1mMore22m
Now a window will be opened that includes more details of the
interrupt.
1mExit22m
Selecting this gadget will close the 1mInterrupts22m window.
Libraries
=========
A library is a collection of functions/procedures, which have to do
certain jobs. E.g. the `graphics.library' includes routines for
graphical display.
Column items
------------
1mAddress22m
Adress of the library structure
1mln_Name22m
Name of a library
1mln_Pri22m
Priority of a library
1mOpenC22m
Here you see, how often the library was opened.
1mRPC22m
1m RPC22m means 1mRAM Pointer Count22m and shows how many jump addresses of
the library point into RAM. In this way many programs -- like the
1msetpatch22m command from Commodore -- patch the system.
Many viruses patch the system in this way too, but don't panic now.
If you check your system in regular intervals with a current virus
killer, it should be out of danger.
If the whole program code of the library is located in RAM, you
will find a dash (minus sign) here, because in this case it's
unimportant how many jump addresses point into RAM.
1mln_Type22m
Type of this structure (usually 1mlibrary22m)
Actions
-------
1mPriority22m
Herewith the priority of the library can be changed. A little
window will be opened, that asks you for a new priority. Through
the new priority it can happen that the library gets a new place
in the list of libraries.
1mClose22m
A library must be closed by all programs, if you want to remove it
from system. In this case the 1mOpenC22m is zero.
If you select this function, you will be asked, how often you want
to close it. You can choose between 1mOnce22m and 1mAll22m.
Select 1mAll22m and the library will so often be closed till the 1mOpenC22m
is zero.
1mRemove22m
The selected library will be removed with this function provided
that no program uses this library anymore and the 1mOpenC22m is zero.
Some libraries can't be removed from system without a reset. So
you shouldn't wonder about it, if this happens.
1mFunctions22m
All library function offsets and addresses are shown up in a
subwindow. If an appropriate 1m.fd22m file exists and an 1mFD:22m assign
points to its directory, then you will also see the function names.
1mUpdate22m
The list of libraries will be updated.
1mPrint22m
This function allows you to send the list of 1mLibraries22m to printer
or a selected file.
1mMore22m
A window will be opened that includes more details of the library.
1mExit22m
Selecting this gadget will close the 1mlibrary22m window.
Locks
=====
A lock structure shows you, that a program reads from or perhaps
write into a file or a directory. With this type of structure the
system prevents, that a file will be deleted while another program gets
some data from it.
Column items
------------
1mAccess22m
Here you can see the type of access. This could be 1mREAD22m, 1mWRITE22m or
1mOWN22m. 1mOWN22m stands for a lock 1mScout22m created to get the elements of
this list.
1mPath22m
Path of the file or directory
Actions
-------
1mUpdate22m
The list of 1mLocks22m will be updated.
1mPrint22m
This function allows you to send the list of 1mLocks22m to printer or a
selected file.
1mRemove22m
A lock will be removed through dos.library's `UnLock()' function.
1mPattern22m
If you give 1mScout22m a pattern, only the locks with a matching path
will be shown.
1mExit22m
The 1mLocks22m window will be closed.
LowMemory
=========
This list contains all low memory handler known to the system.
These handlers are called in their sequence if a memory allocation
is about to fail due to missing resources. The handlers try to free as
much unused memory space as possible.
`ramlib' is such a low memory handler removing unused libraries and
devices from the system's memory. It is always present.
1m Note:22m Low memory handlers are only available since AmigaOS 3.0. On
older systems this list will always be empty.
Column items
------------
1mAddress22m
Address of the low memory handler structure.
1mln_Name22m
Name of the handler.
1mln_Type22m
Type of the handler.
1mln_Pri22m
Priority of the handler. All handlers are called in their priority
sequence.
1mis_Data22m
A pointer to some handler's private data.
1mis_Code22m
A pointer to the low memory handler code.
Actions
-------
1mUpdate22m
The list will be actualized.
1mPrint22m
This function allows you to send the list to printer or a selected
file.
1mRemove22m
The low memory handler will be removed from system.
1mPriority22m
Changes the priority of the selected handler.
1mExit22m
The window will be closed.
Memory
======
In this list you will find the segments of your memory. At least you
will find an entry for your chip memory.
Column items
------------
1mln_Name22m
Name of the memory segment (e.g. 1mchip memory22m)
1mln_Pri22m
Priority of memory
1mmh_Lower22m
First address of memory
1mmh_Upper22m
Last address of memory
Actions
-------
1mPrint22m
This function allows you to send the list of the memory segments to
printer or a selected file.
1mPriority22m
This function allows you to change the priority of a memory
segment. The memory segment with the highest priority will be
preferred from system, provided that no certain type of memory is
demanded.
1mMore22m
Another window will be opened. This window includes more
information about the memory segment.
1mExit22m
The window will be closed.
Mounted Devices
===============
In this list you will find all your devices like disk drives, printer
devices, etc.
Column items
------------
1mName22m
Name of the device
1mUnit22m
Unit number
1mHeads22m
Number of heads
1mCyl22m
Number of cylinders
1mState22m
The state shows you for example, if a disk is in drive.
1mDiskType22m
Type of a disk (e.g. OFS (OldFileSystem), FFS (FastFileSystem),
...)
1mHandler or Device22m
The handler or the device you find here has to manage the stream of
data from and to the device.
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list of 1mMounted Devs22m to
printer or a selected file.
1mExit22m
The window will be closed.
Ports
=====
Programs are able to communicate together through ports.
Column items
------------
1mAddress22m
Here you will find the port structure.
1mln_Name22m
Name of port
1mln_Pri22m
Priority of port
1mmp_SigTask22m
The task is communicating through the port.
Actions
-------
1mUpdate22m
The ports list will be updated.
1mPrint22m
This function allows you to send the list of 1mPorts22m to printer or a
selected file.
1mRemove22m
The port will be removed.
1mPriority22m
Herewith the port priority can be changed.
1mExit22m
The 1mPorts22m window will be closed.
Resident Commands
=================
This list includes all resident commands. That means all commands you
find in ROM and the commands you made `resident' through the 1mresident22m
command.
Positions and sizes of their hunks you will find here, too.
Column items
------------
1mName22m
Name of the command
1mUseCount22m
Here you can see, how often a command was being executed at the
time the list was build.
1mLower22m
First address of hunk in memory
1mUpper22m
Last address of hunk in memory
1mSize22m
Size of hunk (upper - lower - 8 bytes overhead)
Actions
-------
1mUpdate22m
The list of 1mResident Commands22m will be updated.
1mPrint22m
This function allows you to send the list of 1mResident Commands22m to
printer or a selected file.
1mRemove22m
The selected command will be removed with this function provided
that no program uses this command anymore and the 1mUseCount22m is zero.
1mExit22m
The window disappears.
Residents
=========
Resident modules are reset-protected segments (code and data). In
the list of 1mResidents22m you usually find libraries, devices and
resources. A programmer has the possibility to make his own programs
reset-protected. He has to initialize a resident structure for it and
then he can link the program through the kick-vectors (see Vectors) to
the list of the resident modules. The residents you linked to system
are usually located in RAM and are of a different color.
If you find a resident module that points into RAM and you don't know
which program has created it, you should start your favourite virus
detector and let it check your memory. Many viruses prefer this way to
travel around.
Column items
------------
1mAddress22m
At this address the resident module is located.
1mln_Name22m
Name of the resident module
1mrt_Pri22m
Priority
1mrt_IdString22m
Identity string of the resident module.
Actions
-------
1mUpdate22m
The list of 1mResidents22m will be updated.
1mPrint22m
This function allows you to send the list of 1mResidents22m to printer
or a selected file.
1mMore22m
Selecting this gadget opens a new window with more information
about the selected resident module.
1mExit22m
The 1mResidents22m window will be closed.
Resources
=========
Usually a resource is -- like a library (see Libraries) -- a
collection of functions/procedures, which have to do certain jobs.
E.g. the `filesystem.resource' includes functions for the filesystem
handling.
Column items
------------
1mAddress22m
Address of the resource structure
1mln_Name22m
Name of a resource
1mln_Pri22m
Priority of a resource
1mOpenC22m
This element shows how often the resource was opened.
1mRPC22m
1m RPC22m means 1mRAM Pointer Count22m and shows how many jump addresses of
the resource point into RAM. In this way many programs -- like
the 1msetpatch22m command from Commodore -- patch the system.
Many viruses patch the system in this way too, but don't panic now.
If you check your system in regular intervals with a current virus
killer, it should be out of danger.
If the whole program code of the resource is located in RAM, you
will find a dash (minus sign) here, because in this case it's
unimportant how many jump addresses point into RAM.
1mln_Type22m
Type of this structure (usually 1mresource22m)
Actions
-------
1mUpdate22m
The list of 1mResources22m will be updated.
1mPrint22m
This function allows you to send the list of 1mResources22m to printer
or a selected file.
1mRemove22m
The selected resource will be removed with this function, provided
that no program uses it anymore and the 1mOpenC22m is zero.
1mPriority22m
Herewith the priority of the resource can be changed. A small
window will be opened, that asks you for a new priority. Through
the new priority it can happen that the resource gets a new
position in the list of resources.
1mMore22m
Select this gadget and you get a new window with more information
about the selected resource.
1mFunctions22m
All resource function offsets and addresses are shown up in a
subwindow. If an appropriate 1m.fd22m file exists and an 1mFD:22m assign
points to its directory, then you will also see the function
names. Note that some resources do not have functions.
1mExit22m
The 1mResources22m window will be closed.
1m Please note:22m If you should find three dashes (minus signs) at 1mOpenC22m
and/or 1mRPC22m, the resource has no typical library structure. This
happens for example at the `FileSystem.resource'.
ScreenMode
==========
Screen modes define all monitor resolutions that the system is able
to show up.
You surely have already selected a screen mode before. In this list,
you will find all available modes. Most of the programs filter out some
of them when they do not meet their purpose.
Column items
------------
1mModeID22m
An identification number, unique to each mode.
1mWidth22m
Nominal width of the resolution in pixeln.
1mHeight22m
Nominal height of the resolution in pixeln.
1mDepth22m
Maximum number of planes. The amount of colors which can be
simultaneously displayed depends on this.
1mScreenMode22m
Name of the screen mode. Some modes do not have a real name, so
Scout will generate it. Then it might differ from the name
generated by other programs or screen mode requesters.
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list to printer or a selected
file.
1mMore22m
Further information about the screen mode are displayed in a
subwindow. This includes the overscan resolutions and the
frequencies. Due to an inaccuracy of the operating system, the
real frequencies might be a little bit different to those
displayed.
1mExit22m
The window will be closed.
Semaphores
==========
The use of semaphores is a way of single-threading critical
sections. For example only one program is allowed to use the printer
at one time, otherwise the texts would be mixed.
Column items
------------
1mln_Name22m
Name of a semaphore
1mNest22m
This item counts how often the semaphore has been obtained by the
owner task.
1mQueue22m
This counter shows you, how many programs want to obtain the
semaphore.
1mOwner22m
Here you will find the name of the task that owns the semaphore.
Actions
-------
1mUpdate22m
The list of 1mSemaphores22m will be updated.
1mPrint22m
This function allows you to send the list of 1mSemaphores22m to printer
or a selected file.
1mObtain22m
This function is used to gain access to a semaphore. The 1mNestCnt22m
will be increased at one by this call.
1mRelease22m
Herewith you can make a signal semaphore available to others.
1mExit22m
The 1mSemaphores22m window will be closed.
System
======
Actions
-------
1mPrint22m
This function allows you to send the list to printer or a selected
file.
1mExit22m
The window will be closed.
Entry items
-----------
In this window you will find some (partially technical) information
about your computer. Please excuse the ordinary look of the window, but
it is very easy to add more lines this way.
Tasks
=====
In this window you find a list of all tasks and processes being in
system. Each program you start will be executed as a task or process.
Column items
------------
1mln_Name22m
Name of the task/process
1mln_Type22m
Type of the structure (1mtask22m or 1mprocess22m)
1mln_Pri22m
Priority of the task/process
1mNUM22m
If a non detaching program was started from shell, you will find
here the number of the process. Programs you started from
Workbench have a dash here.
1mState22m
Here you see the state of the task or process. You will find
Scout's own process on the top of the list with a 1mrun22m at this
place, because this process is always running when it gets the
task list.
1m ready22m means the task wants to work, but it's interrupted by the
execution of another task.
A task that is waiting for a certain signal is in the state 1mwait22m.
In this case it doesn't need processing time.
1mSigWait22m
Signalmask the task is waiting for.
Actions
-------
1mPrint22m
This function allows you to send the list of 1mTasks22m to printer or a
selected file.
1mFreeze22m
With this function you freeze the selected task. It can still be
found in the list of tasks, but it gets no processing time from
system.
1m Warning:22m If you try to freeze tasks essential to the system
like `input.device', you should have saved all important
data, cause a RESET is the only way out!
1mActivate22m
A frozen task can be activated here.
1mCPU22m
Here you will find a text field and a cycle gadget. This text field
displays -- dependent on the state of the cycle gadget -- the CPU
load in percent.
For the cycle gadget you can choose between three states:
1moff22m
In this case the CPU load won't be displayed. If you select
another state, 1mScout22m will patch some system functions to
calculate the CPU load of all tasks.
1mfull22m
If you select this state, 1mScout22m sets the real cpu load to
100%. That means the total of the CPU loads of all tasks and
processes will be 100%. Therefore nothing will be displayed
in the text field.
1min %22m
1m Scout22m starts a task named 1m« Scout's cheat task »22m to calculate
the real CPU load and it will be displayed in the text field.
1mSecs22m
This string gadget allows you to set the intervall time for
updating of the CPU load display.
1mUpdate22m
The list will be updated.
1mRemove22m
A task will be removed from the list. You should prefer the freeze
function, if you perhaps need this task again.
See also 1mBreak22m!
1mSignal22m
If you select a signal mask, it will be send to the task.
1mBreak22m
A signal mask that includes the signals CTRL-C and CTRL-D will be
send to the task you selected. Many tasks and processes end, if
they receive these signals.
1mPriority22m
The priority of a task can be changed with this function.
1mMore22m
Selecting this gadget will open another window that displays more
informations about the task or the process.
1mExit22m
The window will be closed.
Timer
=====
This window lists all current requests of the timer.device.
Column items
------------
1mAddress22m
Address of the IO request structure.
1mReplyPort22m
Address of the port the request will be replied to.
1mTime22m
Time that this request will stay in this list.
1mUnit22m
There are two different measures: VBlank (which has less overhead)
and MicroHz (which is more accurate).
1mTask22m
Name of the requesting task.
Actions
-------
1mPrint22m
This function allows you to send the list to printer or a selected
file.
1mUpdate22m
The list will be updated.
1mExit22m
The window will be closed.
Vectors
=======
Actions
-------
1mUpdate22m
The displayed vectors will be updated.
1mPrint22m
This function allows you to send the list of 1mVectors22m to printer or
a selected file.
1mExit22m
The window will be closed.
Reset Vectors
-------------
A program can make itself reset-protected by using the reset vectors.
If the vectors are unused, they have a value of zero. The programs
which use the Kick-Vectors (KickTagPtr, KickMemPtr and KickCheckSum)
can also be found in the list of resident structures. See also
Residents.
Auto Vector Interrupts
----------------------
In a computer system with a MC68000 processor you will find the seven
1mAuto Vector Interrupts22m from address $64 to address $7c. Higher
processors (MC68010, etc.) have the VBR (Vector Base Register) that
allows you to move the interrupt table to FAST-MEM. The system will be
a little bit faster then. 1mScout22m uses the VBR if it exists.
Interrupt Vectors
-----------------
Here you see 16 interrupt vectors (IntVecs). These vectors are
located in the `ExecBase' (base structure of the exec.library).
Windows
=======
All screens with the windows opened on them are listed here. Screens
are of a different color as windows.
Column items
------------
1mPos(x,y)22m
x and y position of the screen/window
1mSize(x,y)22m
x and y size of the screen/window
1mTitle22m
Title of the screen/window
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list of 1mWindows22m to printer or
a selected file.
1mClose22m
With this function it is possible to close screens and/or windows.
If you close a screen, all windows on it will be closed too.
1mTo Front22m
The selected screen/window will be popped to front.
1mMore22m
If you select this gadget another window will be opened that
displays more informations about the window or the screen.
1mExit22m
The window will be closed.
Patches
=======
All patches currently installed in the system are listed here.
Column items
------------
1mLibrary22m
Name of the patched resource
1mOffset22m
Decimal and Hex offset of the patched function
1mFunction22m
Name of the patched function. This name is obtained from the
accoring .fd file.
1mState22m
Current state of the patch. This can either be 1mactive22m, 1mdisabled22m or
1mremoved22m.
1mPatcher22m
Name of the program that applied this patch.
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list of 1mPatches22m to printer or
a selected file.
1mEnable22m
If you select this gadget the selected (disabled) patches will be
enabled again.
1mDisable22m
If you select this gadget the selected (enabled) patches will be
disabled.
1m Warning:22m This is a very dangerous action!! Please read the
SaferPatches documentation!
1mExit22m
The window will be closed.
Catalogs
========
All locale catalogs currently loaded are listed here.
Column items
------------
1mcat_Version22m
Version number of the catalog file.
1mcat_Language22m
Language of the catalog file.
1mcat_Name22m
Name of the catalog file.
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list of 1mCatalogs22m to printer
or a selected file.
1mExit22m
The window will be closed.
AudioModes
==========
All AHI audiomodes are listed here.
Column items
------------
1mID22m
ModeID of the AudioMode.
1mName22m
Name of the AudioMode.
1mBits22m
Bits per sample.
1mmin Freq22m
Minimum mixing frequency.
1mmax Freq22m
Maximum mixing frequency.
Actions
-------
1mUpdate22m
The list will be updated.
1mPrint22m
This function allows you to send the list of 1mPatches22m to printer or
a selected file.
1mMore22m
Selecting this gadget will open another window that displays more
informations about the AudioMode.
1mExit22m
The window will be closed.
Scout and AmiTCP
================
This section will show you what you have to do for using 1mScout22m as a
TCP/IP service through 1mAmiTCP22m. Nearly all functions of 1mScout22m can also
be used via 1mAmiTCP22m.
Now some knowledge will be assumed. If you don't know, what kind of
program 1mAmiTCP22m represents, you should read 1mAmiTCP's22m user's manual
before. (See also AmiTCP.)
If you have installed 1mAmiTCP22m, you can use 1mScout22m as client and
server. Except the installed programs of 1mAmiTCP22m you don't need another
program for using 1mScout22m on networks.
If you want to make your computer available for other systems on the
network, you have to do following two steps:
1. Add the line 1mscout 6543/tcp22m to file 1mAmiTCP:db/services22m.
2. Now please add the line 1mscout stream tcp nowait root dh0:scout22m to
file 1mAmiTCP:db/inetd.conf22m. Make sure that the path at the end of
this line is the right path for 1mscout22m.
That's it! If you start 1mAmiTCP22m now, your computer is available for
other systems through using the options 1mHOST22m, 1mUSER22m and 1mPASSWORD22m.
1mExample:22m If I want perform some actions on some system structures
of my own system for example, I have to start 1mScout22m through
something like:
1> scout HOST crash.north.de USER atte PASSWORD secret
If you leave out option 1mPASSWORD22m, you will be asked for the correct
password through the 1mpassword:22m prompt. In this case nobody can see your
password, because it won't be displayed in shell.
If you don't use option 1mUSER22m, 1mAmiTCP22m takes the username that is
actually available in system.
The usage of 1mAmiTCP22m doesn't provide the installation of 1mMUI22m. All of
1mScout's22m shell commands (see also Commands) can be used via network
through 1mAmiTCP22m.
1mExample:22m If I want to get the task list of my system, I have to
use something like:
1> scout HOST crash.north.de USER atte PASSWORD secret Tasks
You and all other users must always identify themselves through
their usernames (option 1mUSER22m) and their passwords (option 1mPASSWORD22m).
It's also possible to allow or deny certain systems the usage of some
services through the file 1mAmiTCP:db/inet.access22m. See also the user's
manual of 1mAmiTCP22m.
If you want to get more informations about the implemented options
and commands, you should also see Options and Commands.
1m NOTE:22m Please take care that the remote system runs the latest Scout
version as well, to avoid incompatibilities.
Scout without MUI
=================
Nearly all through the graphical user interface available functions
of 1mScout22m are also available via shell. Therefore you don't really need
1mMUI22m for using 1mScout22m. But if you want to use 1mScout's22m graphical user
interface, you must have 1mMUI22m in your system.
Options
*******
There are some options for 1mScout22m which you can use, when you start
the program. The following options are available from shell and as
tool types from Workbench.
1mICONIFIED22m
1m Usage:22m 1mICONIFIED22m
If this option is activ, 1mScout22m starts iconified.
1mPORTNAME22m
1m Usage:22m 1mPORTNAME22m=PORTNAME
The name of Scout's ARexx port can be changed into PORTNAME.
Without this option the ARexx port is called `SCOUT.X'. The 1mX22m
stands for a decimal number that will be incremented, if a so
called port already exists.
1mTOOLPRI22m
1m Usage:22m 1mTOOLPRI22m=VALUE
This option allows you to change the priority of Scout's process
into VALUE.
1mSTARTUP22m
1m Usage:22m 1mSTARTUP22m=COMMAND
The variable COMMAND should be an ARexx script or a single ARexx
command. Both (script or command) will be executed, when 1mScout22m
will be started. In this way you can open more than only the main
window by starting. Try for example the command 1mOpenWindow Tasks22m
and you will get two windows by starting (the main window and the
task list window).
(See also Commands.)
1mINTERVALTIME22m
1m Usage:22m 1mINTERVALTIME22m=SECONDS
This options allows you to save your preferred update time for the
list of tasks. (See also Tasks.)
1mCPUDISPLAY22m
1m Format:22m 1mCPUDISPLAY22m=VALUE
Through the variable VALUE you can select the state of the 1mCPU22m
cycle gadget you find in the 1mTasks22m window. (See also Tasks.)
* 1m122m means 1mCPU: full22m
* 1m222m means 1mCPU: in %22m
1mHOST22m
1m Format:22m 1mHOST22m=HOSTNAME
This options allows you to specify the system (HOSTNAME) you want
to manipulate via network through 1mAmiTCP22m.
1mUSER22m
1m Format:22m 1mUSER22m=USERNAME
You have to use this option to identify yourself by using 1mScout22m as
a TCP/IP service.
1mPASSWORD22m
1m Format:22m 1mPASSWORD22m=PASSWORD
Without a password 1mScout22m can't connect to another system via
network. This option allows you to set the correct password.
1mCOMMAND22m
1m Format:22m 1mCOMMAND22m=COMMANDLINE
Nearly all of 1mScout's22m implemented functions are available from
shell through this option. You don't need the 1mCOMMAND22m key to use
this option. (See also Commands.)
1mSINGLEWINDOWS22m
1m Format:22m 1mSINGLEWINDOWS22m
Some users don't like to handle the many windows of Scout. This
option solves the problem of too many windows. If this option is
selected, only one list window and only one detail window is
opened at a time.
Scout's commands via ARexx and shell
************************************
1mScout22m supports two kinds of commands:
1. commands only available from shell
2. commands available from ARexx and shell
ARexx port
----------
It's a feature of 1mMUI22m to give each application its own ARexx port.
Therefore 1mScout22m also has an ARexx port that usually has the name
1mSCOUT.X22m. The 1mX22m stands for a decimal number that will be incremented, if
a so called port already exists.
You will find the name of 1mScout's22m ARexx port in the window you get,
if you select the 1mProject/About22m menu.
Using tasknames:
----------------
If a task or a process was started from shell and hasn't detached
itself, you will find the name of the command being executed, where
usually the taskname is displayed. The real name of those tasks
usually is something like 1mBackground CLI22m, but such a taskname isn't
useful.
1m Example:22m If you start a non detaching task like 1mDH0:Debug/Sushi22m
from shell, you will see 1mDH0:Debug/Sushi22m as taskname.
Some ARexx commands need a taskname as parameter. You have to select
those from CLI started self detaching tasks by using their command
names like 1mScout22m displays them in the lists of tasks.
Commands only available from shell
==================================
1mHelp22m
1m Format:22m 1mHelp22m
This command is the most important one and it doesn't need
parameters. If you try 1mHelp22m, 1mScout22m prints a list of all available
commands to shell. =:^)
Now 18 commands follow. These commands allow the user to get all
lists of system structures from shell. Therefore you only need to
install 1mMUI22m for using 1mScout's22m graphical user interface.
Each of the following commands has a shortened form that stands
behind the command in parentheses.
1m Allocations22m (a), 1mBoopsiClasses22m (b), 1mCommands22m (c), 1mDevices22m (d),
1mTimer22m (e), 1mFonts22m (f), 1mAssigns22m (g), 1mInputHandlers22m (h), 1mInterrupts22m
(i), 1mLowMemory22m (j), 1mCommodities22m (k), 1mLibraries22m (l), 1mMemory22m (m),
1mMounts22m (n), 1mLocks22m (o), 1mPorts22m (p), 1mResidents22m (r), 1mSemaphores22m (s),
1mTasks22m (t), 1mResources22m (u), 1mVectors22m (v), 1mWindows22m (w), 1mExpansions22m
(x), 1mSystem22m (y) and 1mScreenMode22m (z).
1mExample:22m To get the list of ports, you only have to use 1mscout
ports22m or 1mscout p22m from shell.
Commands available from ARexx and shell
=======================================
1mFindTask22m
1m Usage:22m 1mFindTask22m TASK
This command allows you to check, if task TASK exists in system or
not. The result is the address of the task TASK, if it has been
found. TASK can be the name or the address of a task.
1mFreezeTask22m
1m Usage:22m 1mFreezeTask22m TASK
The task TASKNAME will be frozen. After that it will still be
found in system's task list, but then it doesn't need processing
time. You can choose the name or the address of a task for TASK.
1mActivateTask22m
1m Usage:22m 1mActivateTask22m TASK
If task TASK was frozen, it will be activated, otherwise an error
occured. TASK is again a task's name or an address.
1mRemoveTask22m
1m Usage:22m 1mRemoveTask22m TASK
This command removes the task TASK. It's lost forever.
1mBreakTask22m
1m Usage:22m 1mBreakTask22m TASK
1m Scout22m sends the task TASK a certain signal mask that includes the
signals CTRL-C and CTRL-D. Many programs support these signals and
finish themselves, if they receive one of them.
1mSignalTask22m
1m Usage:22m 1mSignalTask22m TASK HEXSIGNAL
This command allows you to send a signal HEXSIGNAL to the task
TASK. The signal must specified as a hexadecimal number.
1m Example:22m
SendSignal 'scout' 0x001000
sends task 1mscout22m a CTRL-C and after that 1mScout22m ends.
1mSetTaskPri22m
1m Usage:22m 1mSetTaskPri22m TASK PRIORITY
The task TASK gets a new priority (PRIORITY).
1mRemovePort22m
1m Usage:22m 1mRemovePort22m PORT
The port PORT will be removed from 1mScout22m. PORT can be the name of
a port or its address.
1mGetLockNumber22m
1m Usage:22m 1mGetLockNumber22m LOCKPATTERN
This command returns the number of locks which have paths matching
to the pattern LOCKPATTERN.
1m Example:22m Use the command
GetLockNumber 'WORK:Utilities/#?'
and you will know, how many locks are currently used for files in
the directory 1mWORK:Utilities/22m.
1mRemoveLocks22m
1m Usage:22m 1mRemoveLocks22m LOCKPATTERN
Use this command and all locks which have paths matching to the
pattern LOCKPATTERN will be removed. (See also 1mGetLockNumber22m.)
1mRemoveLock22m
1m Format:22m 1mRemoveLock22m LOCKADDRESS
The lock at adress LOCKADDRESS will be removed.
1mFindNode22m
1m Usage:22m 1mFindNode22m NODETYPE NODENAME
This command allows you to find a certain node. You only have to
know its name (NODENAME) and its type (NODETYPE).
NODETYPE can have following values: 1mLIBRARY22m, 1mDEVICE22m, 1mRESOURCE22m,
1mMEMORY22m, 1mSEMAPHORE22m, 1mPORT22m or 1mINPUTHANDLER22m.
1m Example:22m If you want to get the address of the 1mdisk.resource22m you
must use:
FindNode RESOURCE 'disk.resource'
1mGetPriority22m
1m Usage:22m 1mGetPriority22m NODEADDRESS
This command allows you to check the priority of a certain node
structure. This includes all following structure types: tasks,
libraries, devices, resources, ports, residents, input handlers,
interrupts, semaphores and the elements of the memory list.
You only have to know the address (NODEADDRESS) of that structure.
1m Example:22m The following ARexx commands store the priority of your
chip memory in the variable 1mpri22m:
FindName MEMORY 'chip memory'
addr = result
GetPriority addr
pri = result
1mSetPriority22m
1m Usage:22m 1mSetPriority22m NODETYPE NODENAME
If you want to change the priority of the node NODENAME, you can
use this command. Again NODETYPE can have following values:
1mLIBRARY22m, 1mDEVICE22m, 1mRESOURCE22m, 1mMEMORY22m, 1mSEMAPHORE22m, 1mPORT22m or 1mINPUTHANDLER22m.
1mCloseLibrary22m
1m Format:22m 1mCloseLibrary22m LIBRARY
The library LIBRARY will be closed once. LIBRARY can be the name
of the library or its address.
1mRemoveLibrary22m
1m Format:22m 1mRemoveLibrary22m LIBRARY
The library LIBRARY will be removed, if no program uses it.
1mRemoveDevice22m
1m Format:22m 1mRemoveDevice22m DEVICE
The selected device DEVICE will be removed. For DEVICE use the
name or the address of the device.
1mRemoveResource22m
1m Format:22m 1mRemoveResource22m RESOURCE
The resource RESOURCE will be removed.
1mObtainSemaphore22m
1m Format:22m 1mObtainSemaphore22m SEMAPHORE
This command allows you to obtain the given semaphore. SEMAPHORE
can be the semaphore's name or address.
1mReleaseSemaphore22m
1m Format:22m 1mReleaseSemaphore22m SEMAPHORE
The semaphore SEMAPHORE will be once released.
1mRemoveSemaphore22m
1m Format:22m 1mRemoveSemaphore22m SEMAPHORE
You are able to remove the semaphore SEMAPHORE by using this
command.
1mRemoveInputhandler22m
1m Format:22m 1mRemoveInputhandler22m INPUTHANDLER
The input handler INPUTHANDLER selected through name or address
will be removed.
1mFindResident22m
1m Usage:22m 1mFindResident22m RESIDENT
This command returns the address of the resident structure
RESIDENT.
1mFindInterrupt22m
1m Usage:22m 1mFindInterrupt22m INTERRUPTNAME
The address of the interrupt INTERRUPTNAME will be returned.
1mRemoveInterrupt22m
1m Format:22m 1mRemoveInterrupt22m INTERRUPTNAME
The interrupt you have selected through INTERRUPTNAME will be
removed.
1mFlushDevs22m
1m Usage:22m 1mFlushDevs22m
All not used devices will be removed. The used memory will be
freed.
1mFlushFonts22m
1m Usage:22m 1mFlushFonts22m
If a diskfont is in memory, but no program uses it, it will be
removed.
1mFlushLibs22m
1m Usage:22m 1mFlushLibs22m
All not used libraries will be removed. The used memory will be
freed.
1mFlushAll22m
1m Usage:22m 1mFlushAll22m
This function includes 1mFlushDevs22m, 1mFlushFonts22m and 1mFlushLibs22m. All
not used devices, libraries and fonts will be removed and the used
memory will be freed.
1mClearResetVectors22m
1m Usage:22m 1mClearResetVectors22m
The six reset vectors will be cleared, if you select this function
(see Vectors).
1mPopToFront22m
1m Usage:22m 1mPopToFront22m TITLE
This command allows you to pop a screen or window to front. You
only have to know its (TITLE).
1mCloseWindow22m
1m Usage:22m 1mCloseWindow22m WINDOWTITLE
This command closes the window that is specified through its title
(WINDOWTITLE).
1mCloseScreen22m
1m Usage:22m 1mCloseScreen22m SCREENTITLE
If you select this command, the screen (SCREENTITLE) will be
closed with all its windows.
1mCloseFont22m
1m Format:22m 1mCloseFont22m ADDRESS
The font at address ADDRESS will be closed once.
1mRemoveFont22m
1m Format:22m 1mRemoveFont22m ADDRESS
This command removes the font at address ADDRESS, if it's not used
by any program.
1mRemoveCommand22m
1m Format:22m 1mRemoveCommand22m ADDRESS
1m Scout22m makes the resident command at address ADDRESS not resident.
1mRemoveAssign22m
1m Format:22m 1mRemoveAssign22m NAME
With this command you're able to remove the assign NAME.
1mRemoveAssignList22m
1m Format:22m 1mRemoveAssignList22m NAME ADDRESS
This command removes the directory at address ADDRESS from assign
NAME. You will find the address of that directory in the list of
assigns.
1mPrintList22m
1m Format:22m 1mPrintList22m LISTCHARACTER FILENAME
This command allows you to print a list (specified by the
listcharacter) into the file FILENAME.
1m Example:22m
PrintList t 'ram:tasklist'
will print the list of tasks into the file 'ram:tasklist'.
1mOpenWindow22m
1m Usage:22m 1mOpenWindow22m WINDOWID
All windows you get if you select a gadget of 1mScout's22m main window,
can be opened with this command. The WINDOWID is the same text you
find on the main window gadgets.
1m Example:22m
OpenWindow 'Mounted Devs'
will open the window with the list of mounted devices.
1mCxAppear22m
1mCxDisappear22m
1mCxEnable22m
1mCxDisable22m
1mCxKill22m
1mCxListChg22m
1mCxUnique22m
1m Format:22m 1mCx...22m NAME
Sends the command to the commodity named NAME.
1mRemoveCx22m
1m Format:22m 1mRemoveCx22m COMMODITY
Removes the appropriate commodity from the list. Please consider
this as `emergency break'. Use it only if 1mCxKill22m failed.
1mSetCxPri22m
1m Format:22m 1mSetCxPri22m COMMODITY PRIORITY
Sets the priority of a commodity.
1mRemoveClass22m
1m Format:22m 1mRemoveClass22m CLASS
The appropriate BOOPSI class is removed, if no objects and no
subclasses are existing.
How to get updates
==================
The newest version of 1mScout22m should always be available on AmiNet or
Public Domain collections, which are up-to-date.
You can also find the latest version on my home page:
http://www.is-koeln.de/einwohner/shred/
Credits
=======
Now we have to thank some people for supporting the development of
1mScout22m on many different kinds:
* Klaus `gizmo' Weber, he was always available to Atte and his many
questions (not a few) during the programming of 1mScout22m.
* Christian `cosinus' Stelter, he gave the permission to use his
many manuals.
* Stefan Stuntz for his great 1mMagicUserInterface22m
* all (hopefully still) bug reporting and feature requesting people:
Kai `wusel' Siering, Martin Hauner, Peter Meyer, Karl `Charly'
Skibinski, Michael `Mick' Hohmann, Thore B"ockelmann, Bernardo
Innocenti, Daniel Lundberg, ...
and last but not least
* all the others we've forgotten for reporting bugs, sending
expansion boards data and so on.
How to reach the author
=======================
If you have questions, suggestions, bug reports or anything else, you
can contact me at:
Richard K"orber
Hornstrasse 20
51465 Bergisch Gladbach
- Germany -
E-Mail: shred@chessy.aworld.de
richard.koerber@koeln.netsurf.de
Send E-Mails whenever possible..
If you want to contact Andreas Gelhausen, you can reach him at:
Andreas Gelhausen
Graf Spee Str. 23b
26123 Oldenburg
- Germany -
E-Mail: atte@crash.north.de
Please do not contact him for bug reports, suggestions and similar.
But if you feel the urge to send a gift, then he is the right address!
That's it! =:^)
Index
*****
AHI ... AudioModes
Allocations ... Allocations
AmiTCP ... AmiTCP
ARexx ... Commands
ARexx port ... Commands
Assigns ... Assigns
AudioModes ... AudioModes
Author Info ... Author Info
Boards ... Expansions
BoopsiClasses ... BoopsiClasses
Catalogs ... Catalogs
Command ... Commands
Command Line Options ... Options
Commodities ... Commodities
Contents ... Copyright
Copying ... Copyright
Copyright ... Copyright
Credits ... Credits
Device names, logical ... Assigns
Devices ... Devices
DISKFONT ... Fonts
Distribution ... Copyright
Expansions ... Expansions
Fonts ... Fonts
FreeWare ... Copyright
Handler, LowMemory ... LowMemory
Hardware ... Expansions
Identify ... Identify
Input events ... InputHandlers
InputHandlers ... InputHandlers
Installation ... Installation
Interrupts ... Interrupts
Introduction ... Introduction
Legalities ... Copyright
Liability ... Copyright
Libraries ... Libraries
Limitation ... Copyright
Locks ... Locks
Logical device names ... Assigns
LowMemory ... LowMemory
MagicUserInterface ... MUI
Main Window ... Using Scout
Manufacturer ... Expansions
Memory ... Memory
Mounted Devices ... Mounted Devs
MUI ... MUI
No Warranty ... Copyright
Options ... Options
Patches ... Patches
Ports ... Ports
Processes ... Tasks
RAM Pointer Count ... Devices
Resident Commands ... Resident Cmds
Residents ... Residents
Resource allocation ... Allocations
Resources ... Resources
ROMFONT ... Fonts
RPC ... Devices
ScreenMode ... ScreenMode
Screens ... Windows
Semaphores ... Semaphores
System ... System
System Requirements ... System Requirements
Tasknames ... Commands
Tasks ... Tasks
TCP/IP ... AmiTCP
Timer ... Timer
Tool Types ... Options
Trademarks ... Copyright
Updates ... Updates
Using Scout ... Using Scout
VBR ... Vectors
Vectors ... Vectors
Vertical blank interrupt ... Interrupts
What is Scout? ... Introduction
Windows ... Windows